﻿<html xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:mshelp="http://msdn.microsoft.com/mshelp"
xmlns:mshelp="http://msdn.microsoft.com/mshelp" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5"
xmlns:msxsl="urn:schemas-microsoft-com:xslt">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    
    <meta name="save" content="history" />
    <title>Areas and Iterations</title>
    <meta name="Language" content="en-us" />
    <meta name="System.Keywords" content="area paths, system fields" />
    <meta name="System.Keywords" content="iterations, field definition" />
    <meta name="System.Keywords" content="work item fields, area and iteration paths" />
    <meta name="Microsoft.Help.Id" content="27761225-0298-456f-a5bc-f55efbe29529" />
    <meta name="Description" content="You use the area and iteration fields to categorize work into product areas and iteration or sprint cycles. These fields display entries in a hierarchical or tree structure." />
    <meta name="Microsoft.Help.ContentType" content="Concepts" />
    <meta name="DCSext.ProductFamily" content="LIB_DG" />
    <meta name="DCSext.Product" content="ALM_TeamFoundation" />
    <meta name="DCSext.Title" value="Areas and Iterations" />
    <link rel="stylesheet" type="text/css" href="../styles/presentation.css" />
    
    <script type="text/javascript" src="../scripts/EventUtilities.js"> </script>
    <script type="text/javascript" src="../scripts/SplitScreen.js"> </script>
    <script type="text/javascript" src="../scripts/Dropdown.js"> </script>
    <script type="text/javascript" src="../scripts/script_manifold.js"> </script>
    <script type="text/javascript" src="../scripts/script_feedBack.js"> </script>
    <script type="text/javascript" src="../scripts/CheckboxMenu.js"> </script>
    <script type="text/javascript" src="../scripts/CommonUtilities.js"> </script>
    <xml><MSHelp:Keyword Index="A" Term="27761225-0298-456f-a5bc-f55efbe29529" /><MSHelp:Keyword Index="K" Term="area paths, system fields" /><MSHelp:Keyword Index="K" Term="iterations, field definition" /><MSHelp:Keyword Index="K" Term="work item fields, area and iteration paths" /><MSHelp:Attr Name="RevisionNumber" Value="16" /><MSHelp:Attr Name="AssetID" Value="27761225-0298-456f-a5bc-f55efbe29529" /><MSHelp:Attr Name="Abstract" Value="You use the area and iteration fields to categorize work into product areas and iteration or sprint cycles. These fields display entries in a hierarchical or tree structure. These structures are useful for assigning work to specific project areas and ..." /><MSHelp:Attr Name="CommunityContent" Value="1" /><MSHelp:Attr Name="ShippedIn" Value="vs.90" /><MSHelp:Attr Name="TopicVersion" Value="10.0.10236.10000" /><MSHelp:Attr Name="Catalog Container" Value="System_Default_Catalog" /><MSHelp:Attr Name="Content Set Container" Value="System_Default_Content_Set" /><MSHelp:Attr Name="TopicType" Value="kbArticle" /><MSHelp:Attr Name="Locale" Value="en-us" /></xml>
</head>
<body>
	<input type="hidden" id="userDataCache" class="userDataStyle" />
	<input type="hidden" id="hiddenScrollOffset" />
	<img id="collapseImage" style="display:none; height:0; width:0;" src="../icons/collapse_all.gif" alt="Collapse image" title="Collapse image" />
	<img id="expandImage" style="display:none; height:0; width:0;" src="../icons/expand_all.gif" alt="Expand Image" title="Expand Image" />
	<img id="collapseAllImage" style="display:none; height:0; width:0;" src="../icons/collapse_all.gif" />
	<img id="expandAllImage" style="display:none; height:0; width:0;" src="../icons/expand_all.gif" />
	<img id="dropDownImage" style="display:none; height:0; width:0;" src="../icons/dropdown.gif" />
	<img id="dropDownHoverImage" style="display:none; height:0; width:0;" src="../icons/dropdownHover.gif" />
	<img id="copyImage" style="display:none; height:0; width:0;" src="../icons/copycode.gif" alt="Copy image" title="Copy image" />
	<img id="copyHoverImage" style="display:none; height:0; width:0;" src="../icons/copycodeHighlight.gif" alt="CopyHover image" title="CopyHover image" />
	<div id="header">
		<table id="topTable" cellspacing="0" cellpadding="0">
			<tr>
				<td>
					<span onclick="ExpandCollapseAll(toggleAllImage)" style="cursor:default;" onkeypress="ExpandCollapseAll_CheckKey(toggleAllImage, event)" tabindex="0">
						<img ID="toggleAllImage" class="toggleAll" src="../icons/collapse_all.gif" /> 
						<label id="collapseAllLabel" for="toggleAllImage" style="display: none;">Collapse All</label>
						<label id="expandAllLabel" for="toggleAllImage" style="display: none;">Expand All</label> 
					</span> 
					<span>    </span> 
					<span id="devlangsDropdown" class="filter" tabindex="0">
						<img id="devlangsDropdownImage" src="../icons/dropdown.gif" /> 
						<label id="devlangsMenuAllLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: All </nobr></label>
						<label id="devlangsMenuMultipleLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: Multiple </nobr></label>
						<label id="devlangsMenuVisualBasicLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: Visual Basic </nobr></label>
						<label id="devlangsMenuCSharpLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: C# </nobr></label>
						<label id="devlangsMenuManagedCPlusPlusLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: Visual C++ </nobr></label>
						<label id="devlangsMenuFSharpLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: F# </nobr></label>
						<label id="devlangsMenuJScriptLabel" for="devlangsDropdownImage" style="display: none;"><nobr>Code: JScript </nobr></label>
					</span> 
				</td>
			</tr>
		</table>
		<div id="devlangsMenu">
			<input id="VisualBasicCheckbox" type="checkbox" data="VisualBasic,vb,'persist'" value="on" onClick="SetLanguage(this)" />
			<label class="checkboxLabel" for="VisualBasicCheckbox">Visual Basic</label><br />
			<input id="CSharpCheckbox" type="checkbox" data="CSharp,cs,'persist'" value="on" onClick="SetLanguage(this)" />
			<label class="checkboxLabel" for="CSharpCheckbox">C#</label><br />
			<input id="ManagedCPlusPlusCheckbox" type="checkbox" data="ManagedCPlusPlus,cpp,'persist'" value="on" onClick="SetLanguage(this)" />
			<label class="checkboxLabel" for="ManagedCPlusPlusCheckbox">Visual C++</label><br />
			<input id="FSharpCheckbox" type="checkbox" data="FSharp,fs,'persist'" value="on" onClick="SetLanguage(this)" />
			<label class="checkboxLabel" for="FSharpCheckbox">F#</label><br />
			<input id="JScriptCheckbox" type="checkbox" data="JScript,cs,'persist'" value="on" onClick="SetLanguage(this)" />
			<label class="checkboxLabel" for="JScriptCheckbox">JScript</label><br />
		</div>
		<table id="bottomTable" cellpadding="0" cellspacing="0">
			<tr id="headerTableRow1">
				<td align="left">
					<span id="runningHeaderText"> </span> 
				</td>
			</tr>
			<tr id="headerTableRow2">
				<td align="left">
					<span id="nsrTitle">Areas and Iterations</span> 
				</td>
			</tr>
			<tr id="headerTableRow3">
				<td align="left">
					<span id="headfeedbackarea" class="feedbackhead">
						<a href="javascript:SubmitFeedback('bjordan@microsoft.com','','','10.0','10.0.10236.10000','%0\dThank%20you%20for%20your%20feedback.%20The%20GovDev%20team%20uses%20your%20feedback%20to%20improve%20documentation.%20While%20we%20are%20reviewing%20your%20feedback,%20we%20may%20send%20you%20e-mail%20to%20ask%20for%20clarification%20or%20feedback%20on%20a%20solution.%20We%20do%20not%20use%20your%20e-mail%20address%20for%20any%20other%20purpose%20and%20we%20delete%20it%20after%20we%20finish%20our%20review.%0\AFor%20further%20information%20about%20the%20privacy%20policies%20of%20Microsoft,%20please%20see%20http://privacy.microsoft.com/en-us/default.aspx.%0\A%0\d','Customer%20Feedback');">
							Send Feedback
						</a>
					</span> 
				</td>
			</tr>
		</table>
		<table id="gradientTable">
			<tr>
				<td class="nsrBottom" background="../icons/gradient.gif" />
			</tr>
		</table>
	</div>
    <div id="mainSection">
        <div id="mainBody">
            <div id="allHistory" class="saveHistory" onsave="saveAll()" onload="loadAll()" />
            <font color="DarkGray"><p /></font>
            <div class="introduction">
                <p>You use the area and iteration fields to categorize work into product areas and iteration
                    or sprint cycles. These fields display entries in a hierarchical or tree structure.
                    These structures are useful for assigning work to specific project areas and time
                    durations, as well as filtering project information in charts and reports. For more
                    information and examples of tree structures for areas and iterations, see <span sdata="link">
                        <a href="http://msdn.microsoft.com/library/6b0d2df4-c638-4637-af93-86db64ca73ab">Create
                            and Modify Areas and Iterations</a></span>.</p>
                <p>You can assign the area and iteration fields to most work items based on a process
                    template for Microsoft Solutions Framework (MSF). You specify values for the area
                    and iterations fields when you create a work item or during a review of the product
                    or iteration backlog. If you defer a work item to a later time, you should change
                    its iteration accordingly.</p>
                <p><span class="label">In this topic</span> </p>
                <ul>
                    <li>
                        <p><a href="#FieldsOnForm">Classification Fields that Appear on Work Item Forms</a>
                        </p>
                    </li>
                    <li>
                        <p><a href="#AdditionalFields">Additional Fields Tracked for Query and Reporting Purposes
                            </a></p>
                    </li>
                </ul>
            </div>
            <a name="FieldsOnForm" />
            <h1 class="heading"><span onclick="ExpandCollapse(sectionToggle0)" style="cursor: default;"
                onkeypress="ExpandCollapse_CheckKey(sectionToggle0, event)" tabindex="0">
                <img id="sectionToggle0" class="toggle" name="toggleSwitch" src="../icons/collapse_all.gif" />Classification
                Fields that Appear on Work Item Forms</span> </h1>
            <div id="sectionSection0" class="section" name="collapseableSection" style="">
                <p>The following table lists the fields that you can use to categorize work items into
                    areas or iterations. All of these fields appear on the forms for all work item types
                    for GovDev for TFS 2010 v1.0. For information about data types and default field
                    attributes, see <span sdata="link"><a href="http://msdn.microsoft.com/library/c735a582-954a-418e-8b12-1b5c0b9857b9">
                        Working with Work Item Fields</a></span>.</p>
                <div class="alert">
                    <table width="100%" cellspacing="0" cellpadding="0">
                        <tr>
                            <th align="left">
                                <img class="note" alt="Important note" title="Important note" src="../icons/alert_caution.gif" /><b>Important
                                </b></th>
                        </tr>
                        <tr>
                            <td>
                                <p>If you define a path name that is longer than 256 characters, you will not be able
                                    to specify it in Office Project. To avoid this problem, define path names of no
                                    more than 10 characters, and do not nest nodes more than 14 levels deep. </p>
                            </td>
                        </tr>
                    </table>
                </div>
                <div class="caption"></div>
                <div class="tableSection">
                    <table width="50%" cellspacing="2" cellpadding="5" frame="lhs">
                        <tr>
                            <th>
                                <p><span class="label">Field name</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Description</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Reference name</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Data type</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Default value of the reportable type attribute</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Default value of the index attribute</span> </p>
                            </th>
                        </tr>
                        <tr>
                            <td>
                                <p><span class="ui">Area</span> </p>
                            </td>
                            <td>
                                <p>Groups work items into product feature or team areas. The area must be a valid node
                                    in the project hierarchy. </p>
                            </td>
                            <td>
                                <p>System.AreaPath</p>
                            </td>
                            <td>
                                <p>TreePath</p>
                            </td>
                            <td>
                                <p>Dimension</p>
                            </td>
                            <td>
                                <p>True</p>
                            </td>
                        </tr>
                        <tr>
                            <td>
                                <p><span class="ui">Iteration</span> </p>
                            </td>
                            <td>
                                <p>Groups work items by named sprints or time periods. The iteration must be a valid
                                    node in the project hierarchy.</p>
                            </td>
                            <td>
                                <p>System.IterationPath</p>
                            </td>
                            <td>
                                <p>TreePath</p>
                            </td>
                            <td>
                                <p>Dimension</p>
                            </td>
                            <td>
                                <p>True</p>
                            </td>
                        </tr>
                    </table>
                </div>
            </div>
            <a name="AdditionalFields" />
            <h1 class="heading"><span onclick="ExpandCollapse(sectionToggle1)" style="cursor: default;"
                onkeypress="ExpandCollapse_CheckKey(sectionToggle1, event)" tabindex="0">
                <img id="sectionToggle1" class="toggle" name="toggleSwitch" src="../icons/collapse_all.gif" />Additional
                Fields Tracked for Query and Reporting Purposes</span> </h1>
            <div id="sectionSection1" class="section" name="collapseableSection" style="">
                <p>The following fields do not appear on work item forms but are tracked for each type
                    of the work items. These fields provide a numeric value for each classification
                    value that is defined for a team project. You can use these fields to filter queries
                    and create reports.</p>
                <div class="caption"></div>
                <div class="tableSection">
                    <table width="50%" cellspacing="2" cellpadding="5" frame="lhs">
                        <tr>
                            <th>
                                <p><span class="label">Field name</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Description</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Reference name</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Data type</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Default value of the reportable type attribute</span> </p>
                            </th>
                            <th>
                                <p><span class="label">Default value of the index attribute</span> </p>
                            </th>
                        </tr>
                        <tr>
                            <td>
                                <p>Area ID</p>
                            </td>
                            <td>
                                <p>The unique ID of the area to which this work item is assigned.</p>
                            </td>
                            <td>
                                <p>System.AreaId</p>
                            </td>
                            <td>
                                <p>Integer</p>
                            </td>
                            <td>
                                <p>None</p>
                            </td>
                            <td>
                                <p>True</p>
                            </td>
                        </tr>
                        <tr>
                            <td>
                                <p>Iteration ID</p>
                            </td>
                            <td>
                                <p>The unique ID of the iteration to which this work item is assigned.</p>
                            </td>
                            <td>
                                <p>System.IterationId</p>
                            </td>
                            <td>
                                <p>Integer</p>
                            </td>
                            <td>
                                <p>None</p>
                            </td>
                            <td>
                                <p>True</p>
                            </td>
                        </tr>
                    </table>
                </div>
            </div>
            <h1 class="heading"><span onclick="ExpandCollapse(seeAlsoToggle)" style="cursor: default;" onkeypress="ExpandCollapse_CheckKey(seeAlsoToggle, event)" tabindex="0">
                <img id="seeAlsoToggle" class="toggle" name="toggleSwitch" src="../icons/collapse_all.gif" />See
                Also</span> </h1>
            <div id="seeAlsoSection" class="section" name="collapseableSection" style="">
                <h4 class="subHeading">Concepts</h4>
                <div class="seeAlsoStyle"><span sdata="link"><a href="http://msdn.microsoft.com/library/9720b88e-474c-451b-b3fe-5253ba24a653">Using System Fields and Fields Defined by the MSF Process Templates</a></span> </div>
                <div class="seeAlsoStyle"><span sdata="link"><a href="http://msdn.microsoft.com/library/c9b6d41c-47ce-4a29-8a1c-ba44d8c4809a">Finding Bugs, Tasks, and Other Work Items</a></span> </div>
                <div class="seeAlsoStyle"><span sdata="link"><a href="http://msdn.microsoft.com/library/814c2dca-cf8f-44bf-bba1-a5d8e293fc05">Query Fields, Operators, Values, and Variables</a></span> </div>
                <div class="seeAlsoStyle"><span sdata="link"><a href="http://msdn.microsoft.com/library/a35b0c0c-2a7a-42b2-a392-dea1ab7c100b">Naming Restrictions in Team Foundation</a></span> </div>
                <h4 class="subHeading">Other Resources</h4>
                <div class="seeAlsoStyle"><span sdata="link"><a href="WorkItemsandWorkflowGovDev.html">Work Items and Workflow (GovDev)</a></span> </div>
                <div class="seeAlsoStyle"><span sdata="link"><a href="WorkItemFieldsGovDev.html">Work Item Fields (GovDev)</a></span> </div>
            </div>
        </div>
        <div id="footer">
            <div class="footerLine">
                <img width="100%" height="3px" src="../icons/footer.gif" alt="Footer image" title="Footer image" />
            </div>
            <span id="feedbackarea">Send <a href="javascript:SubmitFeedback('bjordan@microsoft.com','','','10.0','10.0.10236.10000','%0\dThank%20you%20for%20your%20feedback.%20The%20GovDev%20team%20uses%20your%20feedback%20to%20improve%20documentation.%20While%20we%20are%20reviewing%20your%20feedback,%20we%20may%20send%20you%20e-mail%20to%20ask%20for%20clarification%20or%20feedback%20on%20a%20solution.%20We%20do%20not%20use%20your%20e-mail%20address%20for%20any%20other%20purpose%20and%20we%20delete%20it%20after%20we%20finish%20our%20review.%0\AFor%20further%20information%20about%20the%20privacy%20policies%20of%20Microsoft,%20please%20see%20http://privacy.microsoft.com/en-us/default.aspx.%0\A%0\d','Customer%20Feedback');">
                feedback </a>on this topic or submit an issue at the GovDev for TFS Codeplex Site.</span> 
        </div>
    </div>
</body>
</html>
